home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / TPLAS20.ZIP / TPLAS11.ZIP / TPLAS.DOC < prev   
Encoding:
Text File  |  1994-08-05  |  5.4 KB  |  130 lines
  1. Tom's Plasma!                                 by Tom Dibble, Copyright 1994
  2.  
  3.  
  4.                               *TPLAS MANUAL*
  5.  
  6.  
  7.  
  8. AUTHOR'S NOTE:
  9.  
  10. (See current version documentation for more details.)
  11.  
  12. First off, you'll need a 'C' compiler and an assembler to get anywhere
  13. with these files.  I use Borland C/C++ 3.0, so I know this compiles
  14. and assembles with no difficulties with that package.  Other packages
  15. I can not guarantee.  The first thing you need to do is compile the
  16. data file generator (the *.c file is its source) and run it.
  17.  
  18. DO NOT RUN THE REVISION 1.1 GENERATOR IN THE DIRECTORY HOLDING THE
  19. REVISION 2.0 DATA FILE!!!
  20.  
  21. Run it anywhere else, though.  Then, assemble and link the assembly
  22. file (tplas.asm) as a '.com' file (/t switch in tlink).  Run the
  23. program in the same directory you ran the data-file generator.
  24. That's all you need to do.  Just be sure not to get the two mixed
  25. up; the 1.1 data file will not work with the revision 2.0 program,
  26. nor vice-versa!
  27.  
  28. If you would like to see more effects added to this code, and a 
  29. great deal of modularity added, register the current revision of
  30. the program and ask for a copy of the source code.  The usage 
  31. license on the newer code is identicle to that of this revision,
  32. allowing for free usage as long as I am acknowledged and the code
  33. is significantly altered or added to.  See below for more details.
  34.  
  35.  
  36. USAGE LICENSE:
  37.  
  38. I coded this because I enjoyed it, and I needed something new and
  39. interesting to put up on my screen.
  40.  
  41. With that in mind, I hereby give full permission to anyone reading
  42. this note to use all code listed in the accompanying files in any 
  43. manner which he or she sees fit, so long as I am mentioned in the 
  44. credits and any code directly derived from my own allows these 
  45. same freedoms of use.  That means, use it as you want, give me 
  46. credit, and don't stop anyone else from using it.
  47.  
  48. If you want to contact me about anything here, this is where I can
  49. be reached until May, 1996 (or 1995, if I don't get into the MS
  50. program!):
  51.  
  52.           tomster@wpi.wpi.edu
  53.  
  54. Or, via the good old post office, at
  55.  
  56.           Tom Dibble
  57.           WPI box 2466
  58.           Worcester, MA  01609
  59.  
  60. My mailbox is always open!
  61.  
  62.                                                                  Tom Dibble
  63.                                                                     3-18-94
  64.  
  65.  
  66. KEYBOARD COMMANDS:
  67.  
  68.           <Space>   Toggle the swim window on and off.
  69.           <Enter>   Generate a new fractal.
  70.           '1'-'3'   Variable smoothness.  '1' (rough) is default.
  71.           <Esc>     Get the hell out of here!
  72.  
  73.  
  74. DATA FILE:
  75.  
  76. The data file for this revision of the program (1.1) is revision 1.1.
  77. An earlier data file (made by PLASDAT version 1.0) will not work
  78. properly as the color section for that version was ten times as large
  79. (for no real reason; I still only read 4 palettes).  Likewise, this
  80. version of the data file will not work with an earlier version of the
  81. program.  The result of using revision 1.0 with this data file would
  82. be a "Random" array filled with -1 or 0:  whichever, an un-interesting
  83. display.  Also, revisions past 1.1 can not use this data file.  Make
  84. sure you don't clobber your new-version data file by running the 
  85. data-file generator!  Of course, the generator for the newer version
  86. should be available, so you can reconstruct in such an emergency.
  87.  
  88. The data file is somewhat large at >100k, but it holds information
  89. vital to the program.  The first 40,000 bytes is movement data for
  90. the two pointers.  This is an expansion of a sin/cos function.  The
  91. next 3,072 bytes is the color palette.  Currently, the palette holds
  92. four full palettes, or 1024 colors.  Each byte is a red, blue, or
  93. green index from 0 to 63.  The last 64k is the array of random numbers
  94. for the plasma generator.
  95.  
  96.  
  97. REVISION HISTORY:
  98.  
  99. This is by no means a finished work.  I don't know how much more
  100. I'll do with it before sending it to the great archive in the sky,
  101. but, time permitting, I plan to do a bit more with it at least. 
  102. Some delays in the code would be nice, so that it doesn't blur by
  103. so bad on 486's and lord knows what it would do on a pentium! 
  104. Geesh, just thinking about the speed-up with a decent video card or
  105. VLB ...  Anyways, this is where it is now and where it's been, for
  106. what it's worth.
  107.  
  108. March 19, 1994:  Revision 1.1
  109.  
  110.      Fixed all bugs which had caused anomalies in the fractal
  111.      (involved overflow of byte values).  Shrunk the data file by
  112.      about 28k by reducing the palette stored to that which we used
  113.      (four full palettes, not 40).  Added lots of keyboard
  114.      commands:  <Space> to toggle swim window on and off, <Enter>
  115.      for a new fractal; '1', '2', and '3' for progressively
  116.      smoother fractals ('1' is default).  <Esc> is now the only key
  117.      which exits.  This is also the first version to be uploaded
  118.      for public consumption (I had 1.0 all packaged and ready to
  119.      go, then decided I'd better fix those bugs ...  and I suppose
  120.      I got carried away ...  :->  ).  Source code, for what it's
  121.      worth, included in package, along with data file generator
  122.      source and executable.  Oh, I cleaned up the code a bit as
  123.      well, using the ARG directive rather than obscure equates,
  124.      adding a few helpful comments, etc.
  125.  
  126. March 3, 1994:  Revision 1.0
  127.  
  128.      The first working version!  Start it up, watch it go!  Hit any
  129.      key and it's outta there!  Simple, but cool.
  130.